跳到主要内容
中文系列课

加载资源

概述​

在运行时加载和替换资源是 Rive 的一项重要功能。Rive 文件（.riv）可以包含嵌入资源或引用外部资源。

加载资源的方法​

Rive 支持多种资源加载方法：

  • 嵌入资源：资源直接打包在 .riv 文件中
  • CDN 加载：资源通过 Rive 的 CDN 加载
  • 引用资源：资源通过外部 URL 引用

嵌入资源​

嵌入资源直接存储在 .riv 文件中，无需额外加载步骤。

通过 CDN 加载​

Rive 可以通过其 CDN 自动加载资源。设置 enableRiveAssetCDN 为 true 即可启用。

图片 CDN​

对于通过 CDN 托管的图片资源，确保 URL 可公开访问。

引用资源​

引用资源是在 .riv 文件中通过 URL 或路径引用的外部资源。

处理资源​

示例​

使用资源处理 API​

使用 useRive Hook 实例化新的 Rive 实例时，在参数列表中添加 assetLoader 回调属性。此回调将在运行时检测到的每个资源（从 .riv 文件加载时）被调用，负责处理运行时资源的加载，或让运行时自行加载。

请注意，assetLoader 回调只能与 useRive Hook 一起使用，不能用于 React 运行时默认导出的 <Rive /> 组件。

assetLoader: (asset: rc.FileAsset, bytes: Uint8Array) => boolean;

更多 API 详情请参见 Web (JS) 示例。